home *** CD-ROM | disk | FTP | other *** search
/ Rockford Magazine / Rockford_Magazine_028_19xx_-_de_Disk_1_of_2_Side_A.d64 / gds docs.txt < prev    next >
Text File  |  2023-02-26  |  10KB  |  378 lines
  1. =======================================
  2.   GRAPHICS INTERCHANGE FORMAT DISPLAY
  3.                SYSTEM
  4. =======================================
  5. Copyright Notices and other such stuff:
  6.  
  7. 'GIF' and 'Graphics Interchange Format'
  8. are trademarks of CompuServe, Inc., an
  9. H&R Block Company. (you know... the
  10. guys who you give money to for telling
  11. you how much money you will give to the
  12. Government.)
  13.  
  14. BASIC 8 is a trademark of Walrus Soft-
  15. ware, Inc.
  16.  
  17. The Graphics Interchange Format Display
  18. System, or GIF Display System for
  19. short, or better yet - GDS (mainly
  20. because it's catchy, but also because I
  21. really don't want to type out the whole
  22. thing), is NOT Public Domain.  This
  23. program cannot be sold without the
  24. express written consent of the author
  25. (me).
  26. This program may be distributed freely
  27. as long as all original files are
  28. included with it.
  29.  
  30. GDS falls under the category of
  31. FREEWARE.  All I want for this is the
  32. fame, glory, recognition, and post-
  33. cards.  Yep, you read right! POST-
  34. CARDS.  I kinda collect postcards, and
  35. I would also like to see how far this
  36. program gets distributed.  So if you
  37. use this program regularly, you are
  38. obligated to send me a postcard. 
  39. I guess you can call this POST-
  40. CARDWARE!!!!!
  41. Please send everything you want to send
  42. me to:
  43.  
  44. Eric C. Rafanan
  45. P.O. Box 1428
  46. Dunnellon, FL 32630
  47.  
  48. This includes postcards, comments,
  49. pictures from cute girls, offers for
  50. CEO positions (only from prominent com-
  51. panies please), or better yet - GIFs!
  52. I only have a small collection and ANY-
  53. THING (yes - ANYTHING) would be
  54. appreciated.
  55.  
  56. Anyway, on with the docs...
  57.  
  58.  
  59. GIF Display System
  60.  
  61.  
  62. After using the GIFFY program for the
  63. C64 by John R. Wind, I was impressed. I
  64. also thought that anything the C64 can
  65. do, the C128 can do better. So I set
  66. out to write a C128 GIF Display program
  67. that was easier to use, yet produced
  68. better displays.
  69.  
  70. So here it is.
  71.  
  72. The program actually consists of
  73. several files:
  74.  
  75. 1) GDS          
  76. - This is the Main Module of the GDS
  77.   program. It loads in the 2 support
  78. modules, handles the choosing of the
  79. GIF, the interpretation of the GIF
  80. header, and the actual decompression of
  81. the compressed raster data.
  82.  
  83. 2) GDS.DEFAULTS 
  84. - This file contains the names of the
  85.   default support modules.
  86.  
  87. 3) GDS.D/????   
  88. - Files with this prefix are Display
  89.   Module files.
  90. GDS was written to be modular to allow
  91. different display formats to be used.
  92.  
  93. 4) GDS.X/????   
  94. - Files with this prefix are Extension
  95.   Handler Modules.
  96. GIF files have the option to include
  97. 'updates' in the form of Extension
  98. Blocks, and the Extension Handler
  99. Module takes care of these blocks.
  100.  
  101. =======================================
  102.  
  103. The Main Module
  104.  
  105. The GDS program has been written for
  106. ease of use. Almost everything can be
  107. done through the use of menus.
  108.  
  109. Use the Cursor Keys to highlight a
  110. choice. Use the Return Key to pick it.
  111. Use the ESC Key to abort almost any-
  112. thing (the program will tell you when
  113. it does something else).
  114.  
  115. Most of the menus are self-explanatory,
  116. so I will only cover those areas that
  117. may need a little more clarification.
  118.  
  119. The Main Menu has 3 choices:
  120.  
  121. 1) View a GIF    
  122. - Allows you to view a GIF on Drives 8,
  123.   9, 10, or 11.
  124. You choose the GIF from a Directory
  125. listing.
  126. NOTE - GIFs must be Program,
  127. Sequential, or User (though non-GEOS)
  128. type files.
  129.  
  130. 2) Exit          
  131. - Pretty self-explanatory.
  132.  
  133. 3) Select Module 
  134. - Allows you to select another Display
  135.   Module or Extension.
  136. Module from Drives 8, 9, 10, or 11.
  137. Also makes it the Default Module as an
  138. option.
  139. NOTE - When you write a new Defaults
  140. file, both the Current Display AND
  141. Extension Modules are made the
  142. Defaults.
  143.  
  144. All the secondary menus are REALLY
  145. self-explanatory (YES/NO, Choose a
  146. Drive, etc.) so I don't think I need to
  147. go into them (after all, if you own a
  148. C128, then you've GOT to have above
  149. average intelligence!).
  150.  
  151.  
  152. The Screen Layout
  153.  
  154.  
  155. The Screen is divided into 3 parts:
  156.  
  157. 1) Credit Blocks 
  158. - This is the upper half of the screen.
  159. The two smaller blocks are credits read
  160. from the Modules (so if you're willing
  161. to program a Module, you can let people
  162. know who did it! It's only fair after
  163. all.).
  164.  
  165. 2) GIF Info      
  166. - The lower left portion of the screen
  167. is used to display information about
  168. the GIF you had chosen.  Most of it
  169. needs no explanation, but here's one
  170. thing to watch out for - I believe
  171. there has been an update to the GIF
  172. format. It has been labeled 'GIF89a'.
  173. GDS recognizes any GIF with the
  174. 'GIF' signature, but it MAY not process
  175. '89a' type GIFs correctly.  Most GIFs
  176. are currently 'GIF87a'.
  177.  
  178. 3) Message Area  
  179. - The lower right portion of the screen
  180.   is the Message Area.
  181. This is where most (if not all) user
  182. interaction will take place.
  183.  
  184. And that's all there is to it!
  185.  
  186. =======================================
  187.  
  188. Getting This Thing Running
  189.  
  190.  
  191. The basic steps to using this program
  192. are:
  193.  
  194. RUN "GDS" ON U(whatever)
  195. (it will load, run, then load in the
  196. Default Modules from the Current Drive)
  197.  
  198. Choose 'View a GIF' from the Main Menu.
  199.  
  200. Pick the Drive the GIFs are on.
  201. (it will then read in all filenames
  202. with the '.GIF' suffix)
  203.  
  204. Highlight and Choose the GIF you want
  205. to view.
  206.  
  207. Confirm your Selection.
  208. (you can abort if all you wanted to do
  209. was look at the GIF info)
  210.  
  211. And away it goes!!!
  212.  
  213. =======================================
  214.  
  215. The Display Module
  216.  
  217.  
  218. The Display Module is the part of the
  219. system that (you guessed it!) actually
  220. displays the GIF.It also is responsible
  221. for doing the color translations.
  222. I chose to make it a module so that
  223. different formats could be chosen
  224. without actually rewriting the entire
  225. program.  These formats can include
  226. 40-column Hi-Res and Multicolor
  227. graphics screens, Basic 8 formats, the
  228. IPaint format, or even custom made
  229. formats.  All it takes is the correct
  230. Display Module.
  231.  
  232. The Main Module takes care of every-
  233. thing (including decompressing the
  234. raster data - that was a toughie!)
  235. except actually putting the picture on
  236. the screen, so it's not hard to come up
  237. with a new Display Module. For any
  238. programmers who are interested, I will
  239. be uploading Programming Notes 'Real
  240. Soon Now'. (Famous Last Words!)
  241.  
  242. There are 3 Display Modules included
  243. with the GDS program:
  244.  
  245. 1) GDS.D/NORMAL    
  246. - This is the Default Module. It is set
  247.   to provide a pretty good display for
  248.   the majority of the GIFs.
  249.  
  250. 2) GDS.D/LIGHTER   
  251. - If the GIFs seem to be coming out too
  252.   dark (alot of 256 color GIFs tend
  253.   to), then this module will attempt to
  254.   make the colors brighter.
  255.  
  256. 3) GDS.D/DARKER    
  257. - This module is set to darken the 
  258.   colors in a GIF.
  259.  
  260. All 3 require 64K of VDC RAM.
  261.  
  262. These Display Modules were coded for
  263. 16-color GIFs, but 4 and 32-color GIFs
  264. still show up pretty good.  Now
  265. 256-color GIFs are another matter...
  266.  
  267. Since the C128 hardware only supports
  268. 16 colors, then to get any reasonable
  269. display of 256 colors requires some
  270. form of SOFTWARE workaround, such as
  271. dithering or interlace (like in IPaint
  272. - gosh, I wish I had the IPaint
  273. format!).  Anyway, the Display Modules
  274. that come with the GDS program are
  275. pretty sad when it comes to 256-color
  276. GIFs (and that's coming from the person
  277. who programmed them!).
  278.  
  279. The Display Modules will 'stretch' or
  280. 'squash' a GIF to fit into the 640x200
  281. Basic 8 format.  It can handle
  282. Interlaced GIF files up to a height of
  283. 200 lines.
  284.  
  285. After viewing the GIF, hitting any key
  286. except for the 'S' key will return you
  287. to the Main Module.
  288.  
  289. The 'S' key allows you to save the GIF
  290. as a 640x200 8x2-color block Basic 8
  291. picture.  After hitting the 'S' key,
  292. you will hear 2 quick bells to notify
  293. you that saving has begun. When it is
  294. done, you will be returned to the Main
  295. Menu.
  296.  
  297. The picture will be saved on the same
  298. disk as the GIF so be sure that there
  299. is enough room on the disk for it
  300. (typically 50-80 disk blocks).  The new
  301. file will have the same name as the GIF
  302. with the addition of the 'PICT.' prefix
  303. and no '.GIF' suffix.
  304.  
  305. **** DO NOT REMOVE ANY DISKS WHILE THE
  306.      GREEN LIGHT IS ON! ****
  307.  
  308. This means you cannot change disks
  309. before saving the picture (actually you
  310. can, but you'll get a disk error
  311. afterwards).  This is a shortcoming of
  312. the Display Module which is currently
  313. being worked on.
  314.  
  315. =======================================
  316.  
  317. The Extension Handler Module
  318.  
  319.  
  320. The Extension Handler Module handles
  321. GIF Extension Blocks.  These Extension
  322. Blocks are used to implement special
  323. functions, give extra GIF info, etc.
  324. that are not provided for in the
  325. standard GIF format.  The Extension
  326. Handler Module provided just ignores
  327. these Extension Blocks.  Actually, I
  328. haven't found any GIFs with Extension
  329. Blocks at all!  If you do, let me know
  330. if the Extension Block Handler works,
  331. eh?  (Sorry about this folks, but you
  332. can't test something if there's nothing
  333. to test it with!)
  334.  
  335. =======================================
  336.  
  337. If you find any problems with this
  338. program, please let me know.  I really
  339. have tried to squash all the bugs, but
  340. my supply of GIFs to test with is VERY
  341. limited.  So if you find anything
  342. wrong, I won't take it too personally.
  343.  
  344. Unfortunately, my lawyers tell me to
  345. inform you that I can't be held
  346. responsible for any damage incurred
  347. through the use of this program.  Not
  348. that there's any chance of that mind
  349. you - none of my equipment has been
  350. damaged and it was used to TEST this
  351. program!  I DID have a problem while
  352. writing the decompression routine
  353. though - I think I developed a new art
  354. form!  I also think I suffered brain
  355. damage looking at it! <just kidding -
  356. really!>
  357. Anyway, about the only way you could do
  358. damage to anything is if you get so
  359. overwhelmed by the incredible pictures
  360. being displayed that you fall over
  361. backwards and startle the cat who jumps
  362. onto your desk and spills your drink
  363. all over your computer!  You shouldn't
  364. have had that drink there anyway...
  365.  
  366. Well that's about it for the
  367. documentation.  I hope I didn't leave
  368. out too much but the program is pretty
  369. easy to run anyway.
  370.  
  371. Enjoy!
  372. Eric C. Rafanan
  373. Qlink: MeEric
  374.  
  375. Copyright 1990
  376. All Rights Reserved
  377. =======================================
  378.